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Built-in File Manager 


Batocera features a built-in file manager that can be accessed by pressing [F1] on the keyboard on 
the main system list (as of right now, PC and RPi4-only). 


Quit the file manager with [Ctrl] + [Q], [Alt] + [F4] or click File > Close Window. 


Overview 


Often overlooked but a crucial piece of software in some cases. Batocera uses the lightweight PCMan 
file manager. 


It's pretty utilitarian, but it gets the job done. 


* Sidebar Taking up the left side of the screen, this shows some quick access shortcuts and all 
the currently mounted drives. 

* Address bar Your current location path. Feel free to click here and type the direct path you 
need to go to. 


o0 Symlinks use the parent path of the symlink file, not the destination's path; that's 
the point of symlinks! 


* Current folder contents The contents of the current folder you're in. 
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Where's all my data? 


The default path of the file manager is /userdata/, which is called "Share" in the sidebar. This is 
due to the fact that this is the default location shown on the network share. Throughout the rest of 
this wiki, the "Share" folder is usually referred to by its direct path of /userdata/ to avoid confusion 
between people using the file manager and those using SSH. 


Applications (advanced standalone emulator configuration) 


If a standalone emulator features a GUI to alter its configuration, it will be featured here. 
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Trash Can 


This is where files are banished to when you delete them using this file manager by default. 
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Do you want to move the file ‘this file ıs garbage!” to trash can 


2 v juserdata/system/.local/share/Trash/files 


By holding [Shift] while pressing [Del] on a file, you can instead immediately delete it. You will 
still be prompted to confirm, but note that it says "Do you want to delete" instead. 
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Do you want to delete the file ‘a file that is rubbishi? 


No Yves 


Free space: 5.5 GiB (Total: 8.3 GiB) 


If you're having trouble removing files from your drive, refer to the specific section about it on the 


troubleshooting page. 


Mount external storage 


Any external storage connected to the Batocera machine is automatically mounted and shown on the 
sidebar (this may take a few moments to mount). This can be used to say transfer ROMs from a USB 
drive storage onto your userdata partition for use with Batocera! 
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Click the “eject” icon next to the drive to safely remove the device from the machine. 


Symlinks 
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Built-in File Manager 


Symlinks, short for symbolic links, can be used to effectively create shortcuts, but better yet, make 
the system believe a single folder/file exists in two different places despite it only taking up the space 
of the single file on the physical drive! The only caveat is that symlinks are supported only on 
modern(ish) file systems: you can't use symlinks if you drive is formatted in FAT32 or exFAT. 


You can create symlinks like so: 


1. Navigate to the folder you wish to link to. 
2. Highlight the folder by clicking on it once. 


3. In the menu at the top, go to Edit > Create Link... 
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4. Navigate to where you would like to create the symlink file. Essentially, this will be where your 
"shortcut" is. 
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"zxspectrum^ inodejdirectory type Free space: 137.3 GiB (Total: 915.9 GiB) 
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Free space: 5.5 GiB (Total: 8.3 GiB} 


"rxspectrum" inodejdirectory type 


5. If desired, rename the symlink to whatever you want. 
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Fe Properttez .nx 
General Permissions 
Name: shortcut to the coole: 
Location: Juserdata/system 
Target file: userdata/ro...zxspectrum 
File type: inode/directory type 
' Total size of files: 25 bytes (25 bytes) 
= Size on disk: 0 bytes (0 bytes) 
Last modification: 12/24/2021 21:13 
Last access: 12/24/2021 21:13 
Last permissions change: 12/24/2021 21:14 
Cancel OK 


Symlinks are incredibly powerful, and can be used to do zany stuff. But remember, all 

this power comes with responsibility: the more complicated you make your symlinks, the 

more complicated it is to maintain them and remember where they all point to and what 
A drives they are dependent on. 


Batocera is not tested against the usage of symlinks, you use them at your own risk. 
Always make backups of your data. 


Deleting a symlink will not delete the original folder/file, even if the prompt might make it seem so. 
Symlink another drive to Batocera 


The above example showcased how to make Batocera's folders accessible from another location, but 
what if you wanted to do the opposite? That is, have Batocera access folders in other locations. This 
can even work for other drives entirely (provided they also use a file system which supports 
symlinks)! 


Using this, you could have a roms/ directory in which all the systems are symlinked to 
folders on their own separate hard-drive! But remember the warning from above, use 
symlinks at your own risk, and backup your data. 


https://wiki.batocera.org/ Printed on 2024/04/08 02:18 


2024/04/08 02:18 


9/14 


Built-in File Manager 


1. In the Batocera userdata drive, rename the folder you want to replace to something different. 
For this example, we'll be replacing the Library folder, so let's rename it to Library -old. 


File Edit View Bookmarks Go Tools 


© v 


Places w 
E. Applications 


Bios 
[Roms 
Screenshots 
ES LAPTOPO.5TB 
|. NO LABEL 
E WD-1TB 
| fedora local. 


userdata 


juserdata 


stfolder 
stversions 
bios 
cheats 
decorations 
extractions 
kodi 
library 
music 
roms 
saves 
screenshots 
shaders 


splash 


Help 


2. Navigate to the secondary drive you want to have Batocera check in and create a new folder 


with the name of the folder you intend to replace. 
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3. Select the newly created folder, and then go to Edit > Create Link... 
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4. Navigate to the original folder on Batocera's userdata partition, and click OK. 
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5. That's it! Now this folder linked to a folder on another drive will be accessed by Batocera 


instead of the regular one in userdata! 
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